home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / utilities / aga / bootscreenaga.lha / BootScreen.DOC < prev    next >
Encoding:
Text File  |  1993-12-25  |  6.3 KB  |  178 lines
  1.  
  2. BOOTSCREEN
  3. ~~~~~~~~~~
  4. "Splash screen" program for Amigas with Workbench release 3.0 (V39) or higher.
  5.  
  6.  
  7. Copyright ©1993 by Joseph Luk.  All rights reserved.
  8.  
  9. ----------------------------------------------------------- MAIN DOCUMENTATION
  10.  
  11. $VER: 1.00 (12/24/93)
  12.  
  13.  
  14. Introduction
  15. ~~~~~~~~~~~~
  16.    Some time ago, I downloaded a cute little utility called "BootPic" (no
  17. 'K' at the end).  This addessed the fact that under OS 2.0 and greater, you
  18. are treated to a blank screen until the Workbench comes up -- very boring and
  19. annoying in that you can't confirm whether or not you're going through a
  20. normal boot sequence.  Correcting the problem, "BootPic" displayed a mock
  21. "Windows" startup screen until the Workbench came up.  The only problem was
  22. that this screen was hard-coded in the program, and the extra-tall PAL screen
  23. and incorrect version number couldn't be corrected.  The author said
  24. that he would probably not add IFF support in the future.
  25.  
  26.    Enter BootScreen.  My program is smaller (8K!), loads an IFF picture, and
  27. also supports AGA 24-bit palettes.
  28.  
  29.  
  30. Requirements
  31. ~~~~~~~~~~~~
  32.    * Amiga with Workbench 3.0 (V39 intuition and graphics library) or better
  33.      installed.
  34.    * Christian A. Weber's iff.library, version 23.2 (05/24/93).  This is a
  35.      tiny PD library that you must install in your LIBS: directory prior to
  36.      running BootScreen.
  37.      
  38.      Thanks to its creator for such a wonderful programming resource!  My
  39.      program would be at least double in size if I used IFFParse!
  40.   
  41.  
  42.    
  43.  
  44. Getting Started
  45. ~~~~~~~~~~~~~~~
  46.    Pop a shell, and type "BootScreen Commodore_Windows".  If a picture comes
  47. up, you're fine.  Shove the screen to the back (which will cause the program
  48. to quit), and proceed to the Installation section appropriate to your
  49. experience level.
  50.  
  51.    If it does not come up, there should be an error message displayed.  If
  52. you have all requirements fulfilled (see above), and still can't get it
  53. to work, contact me (see the section below).
  54.  
  55.  
  56.  
  57.  
  58. Quick Installation (experienced users)
  59. ~~~~~~~~~~~~~~~~~~
  60.    * Copy the executable "BootScreen" to C:.
  61.    * Copy the sample IFF picture file "Commdore_Windows.IFF" to your
  62.      system partition or disk.  I recommend that you place it in
  63.      SYS:Prefs/Presets/.
  64.    * Insert the following line near the beginning of your startup-sequence:
  65.      
  66.      RUN >NIL: BootScreen SYS:Prefs/Presets/Commodore_Windows.IFF
  67.      
  68.      I recommend that you place this line after the "C:Version >NIL:" line.
  69.      
  70.    * Reboot.  Success?  Proceed to the "Program Options" section below to
  71.      learn more.
  72.      
  73.      
  74.      
  75. Normal Installation
  76. ~~~~~~~~~~~~~~~~~~~
  77.  
  78.    BootScreen is intended to be one of the first commands executed as your
  79. computer boots.  To make sure that happens, use your text editor to bring
  80. up a file called "S:Startup-Sequence", which is the script that is executed
  81. every time you boot.  Find the line which says, "C:Version >NIL:" near the
  82. top of the file.  Insert after this line the following:
  83.    
  84.    RUN >NIL: BootScreen SYS:Prefs/Presets/Commodore_Windows.IFF
  85.    
  86.    Now you need to install the picture file.  Open a Shell window, CD to the
  87. directory you extracted this archive from, and type:
  88.  
  89.    copy Commodore_Windows.IFF TO SYS:Prefs/Presets
  90.    
  91.    With that done, you are ready to install the program itself.  Enter the
  92. following command in the same Shell window:
  93.  
  94.    copy BootScreen TO C:
  95.    
  96.    Now the program should work!  Reboot your Amiga with the
  97. CTRL-LeftAmiga-RightAmiga key combination and it should now display a parody
  98. of Microsoft Windows' startup screen when you boot.  Don't like the picture?
  99. Well, you can always change it.  Just replace 
  100. "SYS:Prefs/Presets/Commodore_Windows" with the path and filename of any IFF
  101. picture file you want!
  102.  
  103.  
  104. Program Options
  105. ~~~~~~~~~~~~~~~
  106.    BootScreen's template is (obtained by typing BootScreen ?):
  107.    
  108.          IFFPICTURE/A,FORCENTSC/S:
  109.    
  110.    The arguments are as follows:
  111.    
  112.    IFFPICTURE - (always required) Filespec for the picture you want to
  113.       display.  BootScreen handles standard IFF ILBM pictures (even HAM!)
  114.       saved by just about any Amiga program.  It is capable of using the
  115.       full 24-bit palette of AGA systems.  In fact, I think this is the
  116.       smallest AGA picture viewer around!  :>
  117.       
  118.    FORCENTSC - (switch) Normally, BootScreen disregards the monitor
  119.       specification in an the ILBM file.  This prevents it from failing on
  120.       DblNTSC, Super72, etc. pictures since when the program is run, those
  121.       monitors have not been attached to the system yet.  So it displays
  122.       the picture in the default monitor, which is NTSC, or DblNTSC if you
  123.       have mode promotion turned on.  Since mode promotion doesn't get
  124.       turned on until later in the boot sequence, your boot screen should
  125.       get promoted to DblNTSC while it's being displayed (if you have
  126.       mode promotion tured on, of course).  To prevent this from
  127.       happening, you can specify FORCENTSC, which causes BootScreen to
  128.       display the picture in an NTSC mode, no matter what.
  129.       
  130.       I personally don't mind the re-syncing (it kills the flicker), but
  131.       just thought to make the option available to people who want it.
  132.       
  133.       If you are a PAL system, I can whip up something that has FORCEPAL
  134.       if you want it.
  135.       
  136.       
  137.       
  138.       
  139. Files in this archive
  140. ~~~~~~~~~~~~~~~~~~~~~      
  141.  
  142.    BootScreen                    Version 1.00
  143.  
  144.    BootScreen.C                  SAS/C 6.3 source code.  Compile with
  145.                                  SC LINK BootScreen.c.  (you need the IFF
  146.                                  library include file though)
  147.  
  148.    BootScreen.DOC                The file you're reading!
  149.  
  150.    Commodore_Windows.IFF         Sample picture file, quickgrabbed from
  151.                                  BootPic, shrunk to look right on short NTSC
  152.                                  screens, and modified to display Workbench
  153.                                  release 3.0 version information.  You can
  154.                                  change the version number using the Times 18
  155.                                  font (I think) and repairing the shadow.
  156.                                  
  157.    
  158.  
  159.  
  160.    
  161. Contacting Me  
  162. ~~~~~~~~~~~~~
  163.  
  164. Joseph Luk
  165.  
  166. Internet: jluk@ctp.org
  167. GEnie: J.LUK
  168.  
  169. S-mail: P.O. Box 884401, San Francisco, CA 94188-4401  U.S.A.
  170.  
  171.  
  172. Legal
  173. ~~~~~
  174. This program is public domain.  Enjoy it, share it, modify it, show it off to
  175. your PC-using friends.  My Christmas gift to the Amiga commmunity.
  176.  
  177.  
  178.